Fsymlink

Section: Oct. 7, 1991 (2)
Updated: MiNT Programmer's Manual
Index Return to Main Contents
 

NAME

Fsymlink - create a symbolic link to a file  

SYNOPSIS

LONG Fsymlink( char *oldname, char *newname );
 

DESCRIPTION

Fsymlink creates a new symbolic link (a "soft link") for the file currently named oldname. If the Fsymlink call is successful, then after the call the file may be referred to by either name. A call to Fdelete on the new name will not affect the existence of the file, just of the symbolic link. A a call to Fdelete with the name oldname will actually delete the file, and future references with newname will fail.

Unlike hard links, symbolic links may be made between files on different devices or even different types of file systems.  

RETURNS

0 on success

EINVFN if the file system does not allow symbolic links

An appropriate error code if the new symbolic link cannot be created.  

SEE ALSO

Flink(2), Freadlink(2), Frename(2)  

BUGS

No check is made for the existence of the file named oldname; this could be construed as a feature.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURNS
SEE ALSO
BUGS

This document was created by man2html, using the manual pages.
Time: 16:01:23 GMT, March 03, 2023